﻿<!DOCTYPE html>
<html>
<head>
   <title>Add Conditional Fields</title>
   <meta http-equiv="X-UA-Compatible" content="IE=edge" />
   <meta name="generator" content="Help &amp; Manual" />
   <meta name="keywords" content="Conditional Fields,Conditional Fields add to forms" />
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
   <meta http-equiv="content-language" content="en-us" />
   <meta name="description" content="The conditional display of fields is a feature that allows you to configure select lists, multi-select lists and yes/no type fields so that conditional on a selected list entry..." />
   <meta http-equiv="Content-Style-Type" content="text/css" />
   <link type="text/css" href="default.css" rel="stylesheet" />
   <link id="tabscheme" type="text/css" href="hm_topic.css" rel="stylesheet" />   
<style type="text/css">
/* No header topics */

/* Breadcrumb trail */
p#breadcrumbs {
font-family: Verdana, Tahoma, Helvetica, Sans-Serif;   padding: 2px 0 1px 2px;
   margin: 0;
   font-size: 8pt; 
   color: #999;
   }   
p#breadcrumbs a { color: #999; text-decoration: none;}
p#breadcrumbs a:visited { color: #999; }
p#breadcrumbs a:hover { color: #333; border-bottom: 1px dotted #333; }

/* Search hightlight color */
span.highlight {background-color: #ffff40;}
</style>
<script type="text/javascript">
var hmHeaderTopic = true;

</script> 
<!--[if IE 9]>
<link id="iesvgcss" rel="stylesheet" type="text/css" href="hm_webhelp_svg.css" />
<![endif]-->	
<script src="jquery.js"></script>
<script type="text/javascript" src="jquery.tools.min.js"></script>
<script type="text/javascript" src="jquery.scrollTo-min.js"></script>
<script type="text/javascript"> 
// General topic variables
var tVars = {
   hmHelpPage: "index.html",
   nextP: "update_conditional_fields.htm",
   prevP: "inactivate_a_field.htm",
   currP: "add_conditional_fields.htm",
   defP: "iqcare_module.htm",
   titleP: "Add Conditional Fields",
   mailsubject: "Feedback on: IQCare SCM User Guide V3.5a - Add Conditional Fields",
   simplesubject: "Documentation%20Feedback",
   mailid: "Add_Conditional_Fields",
   mailpath: "IQCare Clinical Interface, Configuration, Form Builder &gt; IQCare Management/Form Builder &gt; Manage Fields &gt; Add Conditional Fields /",
   mailbody: "Dear Support Staff,",
   mailrecipient: "Support Staff <support@ec-software.com>",
   simplerecipient: "support@ec-software.com",
   fbtype: false,
   header: true,
   background: "bg.png",
   tablesReady: false,
   togglesReady: false,
   webRedirect: true
   }
// Popup configuration
 var hmpBShadow = true;
 var hmPopSmallDim = 500;
 var hmPopKillVideo = false;
 // AutoTOC variables
 var hmatocvars = {
   atoc_show: true,
   atoc_title: "Contents",
   atoc_tip: "Jump to:&nbsp;",
   atoc_minHeaders: 3,
   atoc_btntip_off: "No contents entries on this page",
   atoc_btntip_on: "Display/hide topic directory",
   atoc_toptip: "Jump to top of page",
   atoc_top: "Scroll to Top of Page",
   atoc_bg: "#f6f6f6",
   atoc_border: "silver",
   atoc_linkcolor: "#444",
   atoc_linklimit: 45,
   atoc_hovercolor: "#000",
   atoc_hoverbgcolor: "#e0e0e0"
}
// Sortable tables
var sortVars = {
   europeandate: false,
   germanNumbers: false,
   imagePath: "",
   image_up: "arrow-up.gif",
   image_down: "arrow-down.gif",
   image_empty: "arrow-empty.gif",
   image_none: "arrow-none.gif",
   sort_tip: "Click to sort on this column",
   umlauts: "false"
   }

</script>

<script type="text/javascript"> 
$(document).ready(function() {
var doc = document;  
try {
if (parent.hmWebHelp.navWidth != null) doc = parent.document;
doc.title = $("<div/>").html("IQCare SCM User Guide V3.5a - Add Conditional Fields").text();
window.onunload = function() {doc.title = $("<div/>").html("IQCare SCM User Guide V3.5a").text();}
} catch(err) {}
});
</script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="hmtopic.js"></script>

   <script type="text/javascript">
     HMSyncTOC("index.html", "add_conditional_fields.htm");
   </script>
   <script type="text/javascript" src="highlight.js"></script>
   <script type="text/javascript">
     $(document).ready(function(){highlight();});
   </script>
</head>
<body>
<!--ZOOMSTOP-->
<ul id="topictabs" class="tabs">
<li id="indextab" class="hmtabs"><a href="#" id="indextablink" class="current"><span>Add Conditional Fields</span></a></li>
</ul>
<div id="hmbox">
<div id="hmheader">
<div id="hmheadercontents">
 
<h1 class="p_Heading1"><span class="f_Heading1">Add Conditional Fields</span></h1>

</div>
<div id="atocIcon" class="navdivs">
<img class="navicon" id="hmAtocLink" src="contents_off.png" alt="No contents entries on this page" title="No contents entries on this page" />
<br /><span>Contents</span>
</div>
</div>
<div id="autoTocWrapper" class="topicmenu"></div>
<div id="idcontent">
<div id="unclicker"></div>

<!--ZOOMRESTART-->
<p>The conditional display of fields is a feature that allows you to configure select lists, multi-select lists and yes/no type fields so that conditional on a selected list entry or yes/no, one or more associated fields display in IQCare forms. For example, supposed in a select list &nbsp;there is an entry called &quot;Other (specify)&quot;. Upon selecting the Other (specify) select list option, another field such as a text field may become active and available for data to be entered into the field. The benefit of this kind of feature is only associated fields for specific select list entries will be active upon selection, reducing data entry errors.</p>
<p>&nbsp;</p>
<p><span style="font-weight: bold;">Facts About Conditional Fields</span></p>
<p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial Unicode MS','Lucida Sans Unicode','Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>Select lists, multi-select lists and yes/no field types can be configured to have conditional display of fields</p><p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial Unicode MS','Lucida Sans Unicode','Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>Any number of fields can selected as an associated field with a list entry</p><p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial Unicode MS','Lucida Sans Unicode','Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>Any field type can be selected as an associated field with a list entry</p><p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial Unicode MS','Lucida Sans Unicode','Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>In IQCare, all fields associated with select lists that are configured with conditional fields are visible. When an entry option is selected, associated fields become active; fields that have not been configured to be associated with a select list entry option become inactive.</p><p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>One or more of the same fields associated with a conditional field. For example, if the primary field select list has entries A and B; When A is selected - the fields D and E become active; When B is selected - the field D and F become active. Field D is common to both primary select list entries A and B. This is allowed because data for field D can only be entered once on the form. </p><p style="text-align: left; padding: 0px 0px 0px 13px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial Unicode MS','Lucida Sans Unicode','Arial';color:#000000;display:inline-block;width:13px;margin-left:-13px">&#8226;</span>If you have configured a field to be associated with another field, the associated field cannot also be added to a form as a separate field. For example, if you have a field &quot;A&quot; which is associated with field &quot;B&quot; (configured in Manage Fields), you cannot put field &quot;B&quot; on the form. This would actually put the field on the form two times which is not allowed.</p><p>&nbsp;</p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 10px;"><table style="border:none;border-spacing:0px;padding:0px;line-height: normal;"><tr style="vertical-align:baseline"><td style="border:none;padding:0;width:18px"><img id="TOGGLE0186A1_ICON" src="hmtoggle_arrow1.gif" width="9" height="9" alt="hmtoggle_arrow1" style="border:none" /></td><td style="border:none;padding:0"><span style="font-weight: bold;"><a class="dropdown-toggle" href="javascript:HMToggle('toggle','TOGGLE0186A1','TOGGLE0186A1_ICON')">Add Conditional Fields</a></span></td></tr></table></div><div id="TOGGLE0186A1" style="text-align: left; text-indent: -18px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 28px;"><table class="toggletable" style="border:none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:top;">
<td style="vertical-align:top; padding:2px;"><p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">1.</span>Find the field (select list, multi-select list or yes/no field) that you want to configure. Note that this can be a pre-defined or custom field.</p><p>In this example, there is an &quot;Other&quot; family planning method in the select list. We want to associate the text field &quot;FamilyPlanningMethodOther&quot; with the select list option &quot;Other&quot;.</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">2.</span>Click on the gray flower icon in the Associated Fields column</p><p>&nbsp;</p>
<p><img src="conditionalselectlist.png" width="630" height="390" alt="ConditionalSelectList" style="border:none" /></p>
<p>&nbsp;</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">3.</span>Click on the Conditional Fields button</p><p>&nbsp;</p>
<p><span class="f_ImageCaption">Here is the select list for Family Planning Option</span></p>
<p><img src="conditionalviewselectlist.png" width="400" height="370" alt="ConditionalViewSelectList" style="border:none" /></p>
<p>&nbsp;</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">4.</span>Select the list entry you want to associate one or more fields</p><p><img src="conditionalentryselect.png" width="630" height="392" alt="ConditionalEntrySelect" style="border:none" /></p>
<p>&nbsp;</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">5.</span>Using the field select list, find and select the field you would like to associate with the select list field entry &quot;Other&quot;. You can any number of fields.</p><p><img src="conditionalentryselected.png" width="630" height="430" alt="ConditionalEntrySelected" style="border:none" /></p>
<p>&nbsp;</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">6.</span>Type in the field label</p><p><img src="conditionalentrylabel.png" width="630" height="392" alt="ConditionalEntryLabel" style="border:none" /></p>
<p>&nbsp;</p>
<p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">7.</span>Repeat this process by selecting another select list entry for the list you are configuring and adding other conditional fields. You can review your work by returning to any list entry and review the fields that have been configured.</p><p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">8.</span>Click the Submit button to save this configuration</p><p style="text-align: left; padding: 0px 0px 0px 15px; margin: 0px 0px 0px 10px;"><span style="font-size:10pt; font-family: 'Arial';color:#000000;display:inline-block;width:15px;margin-left:-15px">9.</span>Once back in the Manage Fields dialog you <span style="text-decoration: underline;">must</span> click the Save button to save your work.</p><p>&nbsp;</p>
<p><span class="f_ImageCaption">Here is an example of how the display works in IQCare. The field Other family planning method only becomes active if &quot;Other&quot; is selected in the Family Planning Method select list.</span></p>
<p><img src="conditionaliqcareinactive.png" width="630" height="226" alt="ConditionalIQCareInactive" style="border:none" /></p>
<p>&nbsp;</p>
<p><span class="f_ImageCaption">With the selection of &quot;Other&quot; the field Other family planning method becomes active and you enter text in the field.</span></p>
<p><img src="conditionaliqcareactive.png" width="630" height="226" alt="ConditionalIQCareActive" style="border:none" /></p>
</td>
</tr>
</table>
</div>
<p style="text-indent: -18px; margin: 0px 0px 0px 28px;">&nbsp;</p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 10px;"><table style="border:none;border-spacing:0px;padding:0px;line-height: normal;"><tr style="vertical-align:baseline"><td style="border:none;padding:0;width:18px"><img id="TOGGLE0186A2_ICON" src="hmtoggle_arrow1.gif" width="9" height="9" alt="hmtoggle_arrow1" style="border:none" /></td><td style="border:none;padding:0"><span style="font-weight: bold;"><a class="dropdown-toggle" href="javascript:HMToggle('toggle','TOGGLE0186A2','TOGGLE0186A2_ICON')">Conditional Fields Associated with One or More of the Same Fields</a></span></td></tr></table></div><div id="TOGGLE0186A2" style="text-align: left; text-indent: -18px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 28px;"><table class="toggletable" style="border:none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:top;">
<td style="vertical-align:top; padding:2px;"><p>&nbsp;</p>
<p>In this example TBType is associated with P, EP and P plus EP. (This example is starting from the configuration step after you click on the conditional fields button above in Step 3.) </p>
<p>&nbsp;</p>
<p><img src="conditionalmultiexample1.png" width="630" height="392" alt="ConditionalMultiExample1" style="border:none" /></p>
<p>&nbsp;</p>
<p>The PTBType field is available for selection under &quot;P&quot; and under &quot;P+EP&quot;. Shown here under &quot;P&quot;.</p>
<p><img src="conditionalmultiexample2.png" width="630" height="392" alt="ConditionalMultiExample2" style="border:none" /></p>
<p>&nbsp;</p>
<p>Shown here under &quot;P+EP&quot;. A field can be assigned to more than one select list entry when configuring conditional fields.</p>
<p><img src="conditionalmultiexample3.png" width="630" height="392" alt="ConditionalMultiExample3" style="border:none" /></p>
<p>&nbsp;</p>
<p>&nbsp;</p>
</td>
</tr>
</table>
</div>

<!--ZOOMSTOP--> 


</div> <!-- idcontent -->
</div><!-- hmbox --> 
<script type="text/javascript">
HMInitToggle('TOGGLE0186A1_ICON','hm.type','dropdown','hm.state','0','hm.src0','hmtoggle_arrow0.gif','hm.src1','hmtoggle_arrow1.gif','onclick','HMToggle(\'toggle\',\'TOGGLE0186A1\',\'TOGGLE0186A1_ICON\')');
HMInitToggle('TOGGLE0186A1','hm.type','dropdown','hm.state','0');
HMInitToggle('TOGGLE0186A2_ICON','hm.type','dropdown','hm.state','0','hm.src0','hmtoggle_arrow0.gif','hm.src1','hmtoggle_arrow1.gif','onclick','HMToggle(\'toggle\',\'TOGGLE0186A2\',\'TOGGLE0186A2_ICON\')');
HMInitToggle('TOGGLE0186A2','hm.type','dropdown','hm.state','0');
</script>
</body>
</html>
